home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / os2 / xfeel2.arj / MANUAL.DOC < prev    next >
Text File  |  1994-05-05  |  6KB  |  131 lines
  1. Manual for XFeel Version 2.0
  2.  
  3. The new xfeel version now consists of two parts. First the xfeel as known
  4. from versions 1.x and secondly a utility to assign hotkeys to predefined
  5. actions.
  6.  
  7. Necessary files:
  8.     xfeel.exe
  9.     xfeel2.dll
  10.     kbd.dll
  11.     xfeel.ico
  12.  
  13. To install xfeel, put xfeel.exe in your startup folder and xfeel2.dll&kbd.dll
  14. somewhere in your LIBPATH. 
  15.  
  16. After startup a dialog box is shown where you can configure xfeel. With the
  17. buttons 'Save' and 'Load' you can save resp. load a configuration set. If 
  18. you specify a configurationfile as a command line parameter no dialog is
  19. shown at startup.
  20.  
  21. The dialogbox consists of two independent parts:
  22.  
  23. 1. XFeel. By pressing this pushbutton you get another dialog where you can 
  24. specify your xfeel options. There are the following options:
  25. -    turn xfeel on or off.
  26. -    dynamic or static Z-Ordering. With static ordering the window below
  27.     the mouse pointer gets active without being moved to front. With
  28.     dynamic Z-Ordering the window is raised automatically.
  29. -    Hide mouse. The mouse pointer is hidden after typing any key. It gets
  30.     visible again, after a movement of the mouse.
  31. -    Click to front. With static Z-Ordering a window stays in the back,
  32.     as long as you don't click into the titlebar. By specifying this 
  33.     option you can click anywhere into a window to raise it to the top.
  34.  
  35. 2. Hotkeys. This feature uses most of the place in the initial dialog. It
  36. is possible, to assign an action to most of the keys on your keyboard.
  37.  
  38. Proceedings to assign an action to a key:
  39. a.    In the upper listbox all windows are listed that are open right now.
  40.     By doubleclicking on the name or by selecting it and pressing the 
  41.     'Insert' button you move the name to the lower listbox. This is
  42.     a list of windows having assigned an action to them. A window 
  43.     may have several actions assigned to. By selecting a window in
  44.     the lower listbox and pressing the 'Remove' button the window is
  45.     deleted from the lower listbox. There are two special windows shown
  46.     on top of the upper listbox. 'Active window' if you want to specify
  47.     an action for that one resp. 'No Window' if you want a hotkey not
  48.     influencing a predefined window.
  49. b.    After you selected a window in the upper list and by this moved it to
  50.     the lower one, you can assign the hotkey to it. You do this by
  51.     selecting the entry in the listbox and pressing the 'Define' button.
  52.     You get a little dialogbox to assign the key. Press the button
  53.     'Start'. You may now press the key you want assigned. You'll see the
  54.     scancode as well as the modifiers (Shift, Alt, Ctrl) you pressed.
  55.     After you pressed the desired key, you have to press the 'Stop' button
  56.     to acknowledge your choice and to press the 'Ok' button. With the 
  57.     'Test' button you may test, if your hotkey works. If it does you will
  58.     hear a beep. If everything went right you'll see an asterix in front
  59.     of the window name in the lower listbox.
  60. c.    Now you have choosen a window and a key. You still have to defined 
  61.     the action which is to be taken. Again you have to select a window
  62.     shown in the lower listbox. Then you may press the 'Action' button.
  63.     Once more you'll get to another dialogbox. There are two main classes
  64.     of actions. There are standard actions as well as custom actions. For 
  65.     a custom action you have to write your own dll with a function 
  66.     corresponing the following syntax:
  67.  
  68.         void function (HWND window);
  69.  
  70.     The parameter given to your function is the actual window handle of
  71.     the assigned window. You have to enter the name of the dll as well 
  72.     as the name of the function. After marking the checkbox 'Custom 
  73.     action' you get two entryfields, where you can do exactly that.
  74.  
  75.     The other class of actions are standard actions. These are 5 pre-
  76.     defined actions, which probably will be used quite often:
  77.     -    Show Window. The assigned window is brought to front or 
  78.         restored if it was previously minimized. However the window
  79.         aready has to be open.
  80.     -    Close Window. The assigned window is closed.
  81.     -    Minimize window. The assigned window is minimized.
  82.     -    Maximize window. The assigned window is maximized. Didn't
  83.         expect that, did you?   ;-)
  84.     -    Start session. A new session is started. The two entryfields
  85.         'Command' and 'Parameter' get enabled and you can enter the 
  86.         name and eventually the parameter(s) for it. Often you will
  87.         assign a hotkey who starts a session with the window 'No
  88.         Window' assigned to it.
  89.     -    Post Message. Posts a message to the assigned window. The 
  90.         message type may be selected in the combobox 'Message' and 
  91.         the two message parameters in the entryfields 'Param 1' and
  92.         'Param 2'.
  93.  
  94. Some more remarks:
  95. 1.    By pressing the 'Ok' button in the first dialogbox, your settings 
  96.     get active.
  97. 2.    By pressing the 'Unload' button, xfeel is unloaded and therefore no
  98.     more hotkeys are active.
  99. 3.    At startup, if you haven't given a startup file with your own defini-
  100.     tions, there is one predefined action. The hotkey dialog window is 
  101.     assigned to the key 'F12' with the action 'Show Window'. Therefore,
  102.     by pressing 'F12' you may view the xfeel window anytime (as long as
  103.     xfeel is active).
  104. 4.    At the bottom of the dialogbox,is a checkbox named 'Full hierarchy'.
  105.     Normally, in the lower listbox, only the actual window title is
  106.     shown. By marking this checkbox, the names of all parent windows of it
  107.     are shown as well. The names are separated by a '|'.
  108.  
  109.  
  110. Any remarks are welcomed. However no answer is guaranteed. My email
  111. adress you'll find in the 'About' box. However I'll write it here once again.
  112.  
  113.     mhof@iiic.ethz.ch
  114.  
  115.     Have fun
  116.  
  117.         Markus
  118.  
  119. PS: This program is freeware. So you may copy it freely without any restric-
  120. tions under condition, that you let the files intact, as well it would even
  121. be nicer :-( if you'd include this doc-file too.
  122.  
  123. PPS: Wrote a custom action which you think is great, and not too special to
  124. be of some use to other people as well? Don't hesitate, send it to me. I got
  125. a program to uudecode  ;-).
  126.  
  127.  
  128.  
  129.  
  130.     
  131.